home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / utils / unix / unzip-5.12 / zipinfo.doc < prev    next >
Text File  |  1994-08-24  |  21KB  |  450 lines
  1.  
  2. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  3.  
  4. NAME
  5.      zipinfo - list detailed information about a ZIP archive
  6.  
  7. SYNOPSIS
  8.      zipinfo     [-12smlvhtTz]      file[.zip]      [file(s) ...]
  9.      [-x xfile(s) ...]
  10.  
  11.      unzip    -Z    [-12smlvhtTz]    file[.zip]     [file(s) ...]
  12.      [-x xfile(s) ...]
  13.  
  14. DESCRIPTION
  15.      zipinfo lists technical information about  files  in  a  ZIP
  16.      archive, most commonly found on MS-DOS systems.  Such infor-
  17.      mation includes file access permissions, encryption  status,
  18.      type  of  compression,  version and operating system or file
  19.      system of compressing program, and the  like.   The  default
  20.      behavior  (with  no  options) is to list single-line entries
  21.      for each file in the archive, with header and trailer  lines
  22.      providing  summary  information for the entire archive.  The
  23.      format is a cross between Unix ``ls -l''  and  ``unzip  -v''
  24.      output.   See DETAILED DESCRIPTION below.  Note that zipinfo
  25.      is the same program as unzip (under Unix, a link to it);  on
  26.      some systems, however, zipinfo support may have been omitted
  27.      when unzip was compiled.
  28.  
  29. ARGUMENTS
  30.      file[.zip]
  31.           Path of the ZIP archive(s).  If the file  specification
  32.           is  a  wildcard,  each matching file is processed in an
  33.           order determined by the operating system (or file  sys-
  34.           tem).   Only  the  filename can be a wildcard; the path
  35.           itself cannot.  Wildcard  expressions  are  similar  to
  36.           Unix egrep(1) (regular) expressions and may contain:
  37.  
  38.           *    matches a sequence of 0 or more characters
  39.  
  40.           ?    matches exactly 1 character
  41.  
  42.           [...]
  43.                matches any  single  character  found  inside  the
  44.                brackets;  ranges  are  specified  by  a beginning
  45.                character, a hyphen, and an ending character.   If
  46.                an  exclamation point or a caret (`!' or `^') fol-
  47.                lows the left bracket, then the range  of  charac-
  48.                ters within the brackets is complemented (that is,
  49.                anything except the characters inside the brackets
  50.                is considered a match).
  51.  
  52.           (Be sure to quote any character which  might  otherwise
  53.           be  interpreted  or  modified  by the operating system,
  54.           particularly under Unix and VMS.)  If  no  matches  are
  55.           found,  the  specification  is  assumed to be a literal
  56.  
  57. Info-ZIP         Last change: 28 Aug 94 (v2.02)                 1
  58.  
  59. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  60.  
  61.           filename; and if that also fails, the  suffix  .zip  is
  62.           appended.  Note that self-extracting ZIP files are sup-
  63.           ported; just specify the .exe suffix  (if  any)  expli-
  64.           citly.
  65.  
  66.      [file(s)]
  67.           An optional list of archive members  to  be  processed.
  68.           Regular  expressions  (wildcards)  may be used to match
  69.           multiple members; see above.  Again, be sure  to  quote
  70.           expressions  that  would otherwise be expanded or modi-
  71.           fied by the operating system.
  72.  
  73.      [-x xfile(s)]
  74.           An optional list of archive members to be excluded from
  75.           processing.
  76.  
  77. OPTIONS
  78.      -1   list  filenames  only,  one  per  line.   This   option
  79.           excludes all others; headers, trailers and zipfile com-
  80.           ments are never printed.  It is  intended  for  use  in
  81.           Unix shell scripts.
  82.  
  83.      -2   list filenames only, one per line,  but  allow  headers
  84.           (-h), trailers (-t) and zipfile comments (-z), as well.
  85.           This option may be useful in  cases  where  the  stored
  86.           filenames are particularly long.
  87.  
  88.      -s   list zipfile info in short Unix ``ls -l'' format.  This
  89.           is the default behavior; see below.
  90.  
  91.      -m   list zipfile info in  medium  Unix  ``ls  -l''  format.
  92.           Identical to the -s output, except that the compression
  93.           factor, expressed as a percentage, is also listed.
  94.  
  95.      -l   list zipfile info in long Unix ``ls  -l''  format.   As
  96.           with  -m  except that the compressed size (in bytes) is
  97.           printed instead of the compression ratio.
  98.  
  99.      -v   list zipfile information in verbose, multi-page format.
  100.  
  101.      -h   list header line.  The archive name,  actual  size  (in
  102.           bytes) and total number of files is printed.
  103.  
  104.      -t   list totals for files listed or  for  all  files.   The
  105.           number   of   files   listed,  their  uncompressed  and
  106.           compressed total sizes, and their  overall  compression
  107.           factor is printed; or, if only the totals line is being
  108.           printed, the values for the entire archive  are  given.
  109.           Note  that  the total compressed (data) size will never
  110.           match  the  actual  zipfile  size,  since  the   latter
  111.           includes  all  of the internal zipfile headers in addi-
  112.           tion to the compressed data.
  113.  
  114. Info-ZIP         Last change: 28 Aug 94 (v2.02)                 2
  115.  
  116. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  117.  
  118.      -T   print the file dates and times in  a  sortable  decimal
  119.           format  (yymmdd.hhmmss).   The default date format is a
  120.           more standard, human-readable version with  abbreviated
  121.           month names (see examples below).
  122.  
  123.      -z   include the archive comment (if any) in the listing.
  124.  
  125. DETAILED DESCRIPTION
  126.      zipinfo has a number of  modes,  and  its  behavior  can  be
  127.      rather  difficult  to fathom if one isn't familiar with Unix
  128.      ls(1) (or even if one is).  The default behavior is to  list
  129.      files in the following format:
  130.  
  131. -rw-rws---  1.9 unx    2802 t- defX 11-Aug-91 13:48 perms.2660
  132.  
  133.      The last three fields are the modification date and time  of
  134.      the  file,  and  its  name.   The  case  of  the filename is
  135.      respected; thus files  which  come  from  MS-DOS  PKZIP  are
  136.      always  capitalized.   If  the file was zipped with a stored
  137.      directory name, that  is  also  displayed  as  part  of  the
  138.      filename.
  139.  
  140.      The second and third  fields  indicate  that  the  file  was
  141.      zipped  under  Unix with version 1.9 of zip.  Since it comes
  142.      from Unix, the file permissions at the beginning of the line
  143.      are  printed  in  Unix  format.   The uncompressed file-size
  144.      (2802 in this example) is the fourth field.
  145.  
  146.      The fifth field consists of two characters, either of  which
  147.      may  take  on  several  values.   The first character may be
  148.      either `t' or `b', indicating that zip believes the file  to
  149.      be  text  or  binary,  respectively;  but  if  the  file  is
  150.      encrypted, zipinfo notes this fact by capitalizing the char-
  151.      acter  (`T'  or `B').  The second character may also take on
  152.      four values, depending on whether there is an extended local
  153.      header  and/or  an  ``extra field'' associated with the file
  154.      (fully explained  in  PKWare's  APPNOTE.TXT,  but  basically
  155.      analogous  to  pragmas in ANSI C--i.e., they provide a stan-
  156.      dard  way  to  include  non-standard  information   in   the
  157.      archive).  If neither exists, the character will be a hyphen
  158.      (`-'); if there is an extended local  header  but  no  extra
  159.      field,  `l';  if  the  reverse, `x'; and if both exist, `X'.
  160.      Thus the file in this example is (probably) a text file,  is
  161.      not  encrypted,  and  has  neither  an  extra  field  nor an
  162.      extended local  header  associated  with  it.   The  example
  163.      below,  on  the other hand, is an encrypted binary file with
  164.      an extra field:
  165.  
  166. RWD,R,R     0.9 vms     168 Bx shrk  9-Aug-91 19:15 perms.0644
  167.  
  168.      Extra fields are used for various purposes  (see  discussion
  169.      of  the  -v  option below) including the storage of VMS file
  170.  
  171. Info-ZIP         Last change: 28 Aug 94 (v2.02)                 3
  172.  
  173. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  174.  
  175.      attributes, which is presumably the case  here.   Note  that
  176.      the  file  attributes  are listed in VMS format.  Some other
  177.      possibilities for the host operating system (which is  actu-
  178.      ally  a  misnomer--host file system is more correct) inc